home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmText.z / XmText
Encoding:
Text File  |  1998-10-20  |  138.5 KB  |  1,981 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTeeeexxxxtttt - The Text widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////TTTTeeeexxxxtttt....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Text provides a single-line and multiline text editor for
  20.           customizing both user and programmatic interfaces.  It can
  21.           be used for single-line string entry, forms entry with
  22.           verification procedures, and full-window editing.  It
  23.           provides an application with a consistent editing system for
  24.           textual data.  The screen's textual data adjusts to the
  25.           application writer's needs.
  26.  
  27.           Text provides separate callback lists to verify movement of
  28.           the insert cursor, modification of the text, and changes in
  29.           input focus.  Each of these callbacks provides the
  30.           verification function with the widget instance, the event
  31.           that caused the callback, and a data structure specific to
  32.           the verification type.  From this information the function
  33.           can verify if the application considers this to be a
  34.           legitimate state change and can signal the widget whether to
  35.           continue with the action.
  36.  
  37.           The user interface tailors a new set of translations.  The
  38.           default translations provide key bindings for insert cursor
  39.           movement, deletion, insertion, and selection of text.
  40.  
  41.           Text allows the user to select regions of text.  Selection
  42.           is based on the model specified in the _I_n_t_e_r-_C_l_i_e_n_t
  43.           _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l (ICCCM).  Text supports
  44.           primary and secondary selection.
  45.  
  46.         MMMMoooouuuusssseeee SSSSeeeelllleeeeccccttttiiiioooonnnn
  47.           The Text widget allows text to be edited, inserted, and
  48.           selected.  The user can cut, copy, and paste text using the
  49.           clipboard, primary transfer, or secondary transfer.  Text
  50.           also provides a Drag and Drop facility that enables the user
  51.           to copy or move data within Text or to a different widget.
  52.           When keyboard focus policy is set to EXPLICIT, the widget
  53.           that receives focus is the destination widget.  In POINTER
  54.           mode, any keyboard or mouse operation (except secondary
  55.           selection) in an editable widget establishes that widget as
  56.           the destination.
  57.  
  58.           If a destination widget becomes insensitive or uneditable,
  59.           it forfeits its destination status.  In EXPLICIT mode, when
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           a widget becomes insensitive, the focus moves to another
  75.           widget.  If that widget is editable, it becomes the
  76.           destination widget; otherwise, there is no destination
  77.           widget.  The text of any insensitive Text widget is
  78.           stippled, indicating its state to the user.
  79.  
  80.           The insertion cursor, displayed as an I-beam, shows where
  81.           input is inserted.  Input is inserted just before the
  82.           insertion cursor.
  83.  
  84.         CCCCllllaaaasssssssseeeessss
  85.           Text inherits behavior and resources from CCCCoooorrrreeee and PPPPrrrriiiimmmmiiiittttiiiivvvveeee
  86.           classes.
  87.  
  88.           The class pointer is xxxxmmmmTTTTeeeexxxxttttWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  89.  
  90.           The class name is XXXXmmmmTTTTeeeexxxxtttt.
  91.  
  92.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  93.           The following table defines a set of widget resources used
  94.           by the programmer to specify data.  The programmer can also
  95.           set the resource values for the inherited classes to set
  96.           attributes for this widget.  To reference a resource by name
  97.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  98.           prefix and use the remaining letters.  To specify one of the
  99.           defined values for a resource in a .Xdefaults file, remove
  100.           the XXXXmmmm prefix and use the remaining letters (in either
  101.           lowercase or uppercase, but include any underscores between
  102.           words).  The codes in the access column indicate if the
  103.           given resource can be set at creation time (C), set by using
  104.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  105.           not applicable (N/A).
  106.  
  107.                                               XXXXmmmmTTTTeeeexxxxtttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  108.      NNNNaaaammmmeeee                         CCCCllllaaaassssssss                       TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt              AAAAcccccccceeeessssssss
  109.      _____________________________________________________________________________________________________
  110.      XmNactivateCallback          XmCCallback                 XtCallbackList   NULL                 C
  111.      XmNautoShowCursorPosition    XmCAutoShowCursorPosition   Boolean          True                 CSG
  112.      XmNcursorPosition            XmCCursorPosition           XmTextPosition   0                    CSG
  113.      XmNeditable                  XmCEditable                 Boolean          True                 CSG
  114.      XmNeditMode                  XmCEditMode                 int              XmSINGLE_LINE_EDIT   CSG
  115.      XmNfocusCallback             XmCCallback                 XtCallbackList   NULL                 C
  116.      XmNgainPrimaryCallback       XmCCallback                 XtCallbackList   NULL                 C
  117.      XmNlosePrimaryCallback       XmCCallback                 XtCallbackList   NULL                 C
  118.      XmNlosingFocusCallback       XmCCallback                 XtCallbackList   NULL                 C
  119.      XmNmarginHeight              XmCMarginHeight             Dimension        5                    CSG
  120.      XmNmarginWidth               XmCMarginWidth              Dimension        5                    CSG
  121.      XmNmaxLength                 XmCMaxLength                int              largest integer      CSG
  122.      XmNmodifyVerifyCallback      XmCCallback                 XtCallbackList   NULL                 C
  123.      XmNmodifyVerifyCallbackWcs   XmCCallback                 XtCallbackList   NULL                 C
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  137.  
  138.  
  139.  
  140.      XmNmotionVerifyCallback      XmCCallback                 XtCallbackList   NULL                 C
  141.      XmNsource                    XmCSource                   XmTextSource     Default source       CSG
  142.      XmNtopCharacter              XmCTextPosition             XmTextPosition   0                    CSG
  143.      XmNvalue                     XmCValue                    String           ""                   CSG
  144.      XmNvalueChangedCallback      XmCCallback                 XtCallbackList   NULL                 C
  145.      XmNvalueWcs                  XmCvalueWcs                 wchar_t *        (wchar_t *)""        CSG*
  146.      XmNverifyBell                XmCVerifyBell               Boolean          dynamic              CSG
  147.  
  148.           * This resource cannot be set in a resource file.
  149.  
  150.  
  151.           XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk
  152.                     Specifies the list of callbacks that is called
  153.                     when the user invokes an event that calls the
  154.                     AAAAccccttttiiiivvvvaaaatttteeee(((()))) function.  The type of the structure
  155.                     whose address is passed to this callback is
  156.                     XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
  157.                     callback is XXXXmmmmCCCCRRRR____AAAACCCCTTTTIIIIVVVVAAAATTTTEEEE.
  158.  
  159.           XXXXmmmmNNNNaaaauuuuttttooooSSSShhhhoooowwwwCCCCuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
  160.                     Ensures that the visible text contains the insert
  161.                     cursor when set to True.  If the insert cursor
  162.                     changes, the contents of Text may scroll in order
  163.                     to bring the insertion point into the window.
  164.  
  165.           XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnn
  166.                     Indicates the position in the text where the
  167.                     current insert cursor is to be located.  Position
  168.                     is determined by the number of characters from the
  169.                     beginning of the text.  The first character
  170.                     position is 0.
  171.  
  172.           XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee
  173.                     Indicates that the user can edit the text string
  174.                     when set to True.  Prohibits the user from editing
  175.                     the text when set to False.
  176.  
  177.           XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee
  178.                     Specifies the set of keyboard bindings used in
  179.                     Text.  The default keyboard bindings
  180.                     (XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT) provides the set of key
  181.                     bindings to be used in editing single-line text.
  182.                     The multiline bindings (XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT)
  183.                     provides the set of key bindings to be used in
  184.                     editing multiline text.
  185.  
  186.                     The results of placing a Text widget inside a
  187.                     ScrolledWindow when the Text's XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
  188.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT are undefined.
  189.  
  190.           XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
  191.                     Specifies the list of callbacks called when Text
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                     accepts input focus.  The type of the structure
  207.                     whose address is passed to this callback is
  208.                     XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by the
  209.                     callback is XXXXmmmmCCCCRRRR____FFFFOOOOCCCCUUUUSSSS.
  210.  
  211.           XXXXmmmmNNNNggggaaaaiiiinnnnPPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
  212.                     Specifies the list of callbacks called when an
  213.                     event causes the Text widget to gain ownership of
  214.                     the primary selection.  The reason sent by the
  215.                     callback is XXXXmmmmCCCCRRRR____GGGGAAAAIIIINNNN____PPPPRRRRIIIIMMMMAAAARRRRYYYY.
  216.  
  217.           XXXXmmmmNNNNlllloooosssseeeePPPPrrrriiiimmmmaaaarrrryyyyCCCCaaaallllllllbbbbaaaacccckkkk
  218.                     Specifies the list of callbacks called when an
  219.                     event causes the Text widget to lose ownership of
  220.                     the primary selection.  The reason sent by the
  221.                     callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSEEEE____PPPPRRRRIIIIMMMMAAAARRRRYYYY.
  222.  
  223.           XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk
  224.                     Specifies the list of callbacks called before Text
  225.                     loses input focus.  The type of the structure
  226.                     whose address is passed to this callback is
  227.                     XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent by
  228.                     the callback is XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS.
  229.  
  230.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt
  231.                     Specifies the distance between the top edge of the
  232.                     widget window and the text, and between the bottom
  233.                     edge of the widget window and the text.
  234.  
  235.           XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh
  236.                     Specifies the distance between the left edge of
  237.                     the widget window and the text, and between the
  238.                     right edge of the widget window and the text.
  239.  
  240.           XXXXmmmmNNNNmmmmaaaaxxxxLLLLeeeennnnggggtttthhhh
  241.                     Specifies the maximum length of the text string
  242.                     that can be entered into text from the keyboard.
  243.                     This value must be non-negative.  Strings that are
  244.                     entered using the XXXXmmmmNNNNvvvvaaaalllluuuueeee resource or the
  245.                     XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnngggg function ignore this resource.
  246.  
  247.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
  248.                     Specifies the list of callbacks called before text
  249.                     is deleted from or inserted into Text.  The type
  250.                     of the structure whose address is passed to this
  251.                     callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
  252.                     reason sent by the callback is
  253.                     XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple Text
  254.                     widgets share the same source, only the widget
  255.                     that initiates the source change will generate the
  256.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
  273.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss are registered callback
  274.                     lists, the procedure(s) in the
  275.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list are always executed
  276.                     first; and the resulting data, which may have been
  277.                     modified, is passed to the
  278.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.
  279.  
  280.           XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss
  281.                     Specifies the list of callbacks called before text
  282.                     is deleted from or inserted into Text.  The type
  283.                     of the structure whose address is passed to this
  284.                     callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss.  The
  285.                     reason sent by the callback is
  286.                     XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE.  When multiple Text
  287.                     widgets share the same source, only the widget
  288.                     that initiates the source change will generate the
  289.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.
  290.  
  291.                     If both XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk and
  292.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss are registered callback
  293.                     lists, the procedure(s) in the
  294.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk list are always executed
  295.                     first; and the resulting data, which may have been
  296.                     modified, is passed to the
  297.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss callback routines.
  298.  
  299.           XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk
  300.                     Specifies the list of callbacks called before the
  301.                     insert cursor is moved to a new position.  The
  302.                     type of the structure whose address is passed to
  303.                     this callback is XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The
  304.                     reason sent  by the callback is
  305.                     XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR.  It is possible for
  306.                     more than one XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkks to be
  307.                     generated from a single action.
  308.  
  309.           XXXXmmmmNNNNssssoooouuuurrrrcccceeee Specifies the source with which the widget
  310.                     displays text.  If no source is specified, the
  311.                     widget creates a default string source.  This
  312.                     resource can be used to share text sources between
  313.                     Text widgets.
  314.  
  315.           XXXXmmmmNNNNttttooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr
  316.                     Displays the position of text at the top of the
  317.                     window.  Position is determined by the number of
  318.                     characters from the beginning of the text.  The
  319.                     first character position is 0.
  320.  
  321.                     If the XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, the line
  322.                     of text that contains the top character is
  323.                     displayed at the top of the widget without
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  335.  
  336.  
  337.  
  338.                     shifting the text left or right.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss for
  339.                     XXXXmmmmNNNNttttooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr returns the position of the first
  340.                     character in the line that is displayed at the top
  341.                     of the widget.
  342.  
  343.           XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the string value of the Text widget as a
  344.                     cccchhhhaaaarrrr**** data value.  XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are
  345.                     both defined, the value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes
  346.                     that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.  XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of
  347.                     the value of the internal buffer and XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss
  348.                     copies the string values into the internal buffer.
  349.  
  350.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  351.                     Specifies the list of callbacks called after text
  352.                     is deleted from or inserted into Text.  The type
  353.                     of the structure whose address is passed to this
  354.                     callback is XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.  The reason sent
  355.                     by the callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.  When
  356.                     multiple Text widgets share the same source, only
  357.                     the widget that initiates the source change will
  358.                     generate the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk.  This
  359.                     callback represents a change in the source in the
  360.                     Text, not in the Text widget.  The
  361.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk should occur only in pairs
  362.                     with a XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, assuming that the
  363.                     _d_o_i_t flag in the callback structure of the
  364.                     XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk is not set to False.
  365.  
  366.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss
  367.                     Specifies the string value of the Text widget as a
  368.                     wwwwcccchhhhaaaarrrr____tttt**** data value.  This resource cannot be
  369.                     specified in a resource file.
  370.  
  371.                     If XXXXmmmmNNNNvvvvaaaalllluuuueeee and XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss are both defined, the
  372.                     value of XXXXmmmmNNNNvvvvaaaalllluuuueeeeWWWWccccssss supersedes that of XXXXmmmmNNNNvvvvaaaalllluuuueeee.
  373.                     XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss returns a copy of the value of the
  374.                     internal buffer encoded as a wide character
  375.                     string.  XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss copies the value of the wide
  376.                     character string into the internal buffer.
  377.  
  378.           XXXXmmmmNNNNvvvveeeerrrriiiiffffyyyyBBBBeeeellllllll
  379.                     Specifies whether the bell should sound when the
  380.                     verification returns without continuing the
  381.                     action.  The default depends on the value of the
  382.                     ancestor VendorShell's XXXXmmmmNNNNaaaauuuuddddiiiibbbblllleeeeWWWWaaaarrrrnnnniiiinnnngggg resource.
  383.  
  384.  
  385.                                   XXXXmmmmTTTTeeeexxxxtttt IIIInnnnppppuuuutttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  386.      NNNNaaaammmmeeee                     CCCCllllaaaassssssss                    TTTTyyyyppppeeee        DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  387.      ____________________________________________________________________________________
  388.  
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  401.  
  402.  
  403.  
  404.      XmNpendingDelete         XmCPendingDelete         Boolean     True            CSG
  405.      XmNselectionArray        XmCSelectionArray        XtPointer   default array   CSG
  406.      XmNselectionArrayCount   XmCSelectionArrayCount   int         4               CSG
  407.      XmNselectThreshold       XmCSelectThreshold       int         5               CSG
  408.  
  409.  
  410.           XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  411.                     Indicates that pending delete mode is on when the
  412.                     Boolean value is True.  Pending deletion is
  413.                     defined as deletion of the selected text when an
  414.                     insertion is made.
  415.  
  416.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy
  417.                     Defines the actions for multiple mouse clicks.
  418.                     The value of the resource is an array of
  419.                     XXXXmmmmTTTTeeeexxxxttttSSSSccccaaaannnnTTTTyyyyppppeeee elements.  XXXXmmmmTTTTeeeexxxxttttSSSSccccaaaannnnTTTTyyyyppppeeee is an
  420.                     enumeration indicating possible actions.  Each
  421.                     mouse click performed within half a second of the
  422.                     previous mouse click increments the index into
  423.                     this array and performs the defined action for
  424.                     that index.  The possible actions in the order
  425.                     they occur in the default array are:
  426.  
  427.  
  428.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN-resets the insert cursor
  429.                          position
  430.  
  431.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____WWWWOOOORRRRDDDD-selects a word
  432.  
  433.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____LLLLIIIINNNNEEEE-selects a line of text
  434.  
  435.                       +o  XXXXmmmmSSSSEEEELLLLEEEECCCCTTTT____AAAALLLLLLLL-selects all of the text
  436.  
  437.  
  438.           XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyyCCCCoooouuuunnnntttt
  439.                     Indicates the number of elements in the
  440.                     XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.  The value must not be
  441.                     negative.
  442.  
  443.           XXXXmmmmNNNNsssseeeelllleeeeccccttttTTTThhhhrrrreeeesssshhhhoooolllldddd
  444.                     Specifies the number of pixels of motion that is
  445.                     required to select the next character when
  446.                     selection is performed using the click-drag mode
  447.                     of selection.  The value must not be negative.
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  467.  
  468.  
  469.  
  470.                                  XXXXmmmmTTTTeeeexxxxtttt OOOOuuuuttttppppuuuutttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  471.      NNNNaaaammmmeeee                       CCCCllllaaaassssssss                      TTTTyyyyppppeeee         DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  472.      ___________________________________________________________________________________
  473.      XmNblinkRate               XmCBlinkRate               int          500       CSG
  474.      XmNcolumns                 XmCColumns                 short        dynamic   CSG
  475.      XmNcursorPositionVisible   XmCCursorPositionVisible   Boolean      True      CSG
  476.      XmNfontList                XmCFontList                XmFontList   dynamic   CSG
  477.      XmNresizeHeight            XmCResizeHeight            Boolean      False     CSG
  478.      XmNresizeWidth             XmCResizeWidth             Boolean      False     CSG
  479.      XmNrows                    XmCRows                    short        dynamic   CSG
  480.      XmNwordWrap                XmCWordWrap                Boolean      False     CSG
  481.  
  482.  
  483.           XXXXmmmmNNNNbbbblllliiiinnnnkkkkRRRRaaaatttteeee
  484.                     Specifies the blink rate of the text cursor in
  485.                     milliseconds.  The time indicated in the blink
  486.                     rate relates to the time the cursor is visible and
  487.                     the time the cursor is invisible (that is, the
  488.                     time it takes to blink the insertion cursor on and
  489.                     off is twice the blink rate).  The cursor does not
  490.                     blink when the blink rate is set to zero.  The
  491.                     value must not be negative.
  492.  
  493.           XXXXmmmmNNNNccccoooolllluuuummmmnnnnssss
  494.                     Specifies the initial width of the text window as
  495.                     an integer number of characters.  The width equals
  496.                     the number of characters specified by this
  497.                     resource multiplied by the maximum character width
  498.                     of the associated font.  For proportionate fonts,
  499.                     the actual number of characters that fit on a
  500.                     given line may be greater than the value
  501.                     specified.  The value must be greater than 0.  The
  502.                     default value depends on the value of the XXXXmmmmNNNNwwwwiiiiddddtttthhhh
  503.                     resource.  If no width is specified the default is
  504.                     20.
  505.  
  506.           XXXXmmmmNNNNccccuuuurrrrssssoooorrrrPPPPoooossssiiiittttiiiioooonnnnVVVViiiissssiiiibbbblllleeee
  507.                     Indicates that the insert cursor position is
  508.                     marked by a blinking text cursor when the Boolean
  509.                     value is True.
  510.  
  511.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  512.                     Specifies the font list to be used for Text.  If
  513.                     this value is NULL at initialization, the font
  514.                     list is initialized by looking up the parent
  515.                     hierarchy of the widget for an ancestor that is a
  516.                     subclass of the XmBulletinBoard or VendorShell
  517.                     widget class.  If such an ancestor is found, the
  518.                     font list is initialized to the XXXXmmmmNNNNtttteeeexxxxttttFFFFoooonnnnttttLLLLiiiisssstttt of
  519.                     the ancestor widget.  If no such ancestor is
  520.                     found, the default is implementation dependent.
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  533.  
  534.  
  535.  
  536.                     Text searches the font list for the first
  537.                     occurrence of a font set that has a
  538.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG.  If a default element is
  539.                     not found, the first font set in the font list is
  540.                     used.  If the list contains no font sets, the
  541.                     first font in the font list will be used.  Refer
  542.                     to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))) for more information on a font
  543.                     list structure.
  544.  
  545.           XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeHHHHeeeeiiiigggghhhhtttt
  546.                     Indicates that Text attempts to resize its height
  547.                     to accommodate all the text contained in the
  548.                     widget when the Boolean value is True.  If the
  549.                     Boolean value is set to True, the text is always
  550.                     displayed starting from the first position in the
  551.                     source, even if instructed otherwise.  This
  552.                     attribute is ignored when the application uses a
  553.                     ScrolledText widget and when XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll is
  554.                     True.
  555.  
  556.           XXXXmmmmNNNNrrrreeeessssiiiizzzzeeeeWWWWiiiiddddtttthhhh
  557.                     Indicates that Text attempts to resize its width
  558.                     to accommodate all the text contained in the
  559.                     widget when the Boolean value is True.  This
  560.                     attribute is ignored if XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp is True.
  561.  
  562.           XXXXmmmmNNNNrrrroooowwwwssss   Specifies the initial height of the text window
  563.                     measured in character heights. This attribute is
  564.                     ignored if the text widget resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
  565.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  The value must be greater
  566.                     than 0.  The default value depends on the value of
  567.                     the XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt resource.  If no height is specified
  568.                     the default is 1.
  569.  
  570.           XXXXmmmmNNNNwwwwoooorrrrddddWWWWrrrraaaapppp
  571.                     Indicates that lines are to be broken at word
  572.                     breaks (that is, the text does not go off the
  573.                     right edge of the window) when the Boolean value
  574.                     is True.  Words are defined as a sequence of
  575.                     characters separated by white space.  White space
  576.                     is defined as a space, tab, or newline.  This
  577.                     attribute is ignored if the text widget resource
  578.                     XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.
  579.  
  580.                     The following resources are used only when text is
  581.                     created in a ScrolledWindow.  See the man page for
  582.                     XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddTTTTeeeexxxxtttt.
  583.  
  584.  
  585.                         XXXXmmmmTTTTeeeexxxxtttt SSSSccccrrrroooolllllllleeeeddddTTTTeeeexxxxtttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                                          (printed 4/30/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  599.  
  600.  
  601.  
  602.         NNNNaaaammmmeeee                  CCCCllllaaaassssssss           TTTTyyyyppppeeee      DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  603.         ________________________________________________________________
  604.         XmNscrollHorizontal   XmCScroll       Boolean   True      CG
  605.         XmNscrollLeftSide     XmCScrollSide   Boolean   dynamic   CG
  606.         XmNscrollTopSide      XmCScrollSide   Boolean   False     CG
  607.         XmNscrollVertical     XmCScroll       Boolean   True      CG
  608.  
  609.  
  610.           XXXXmmmmNNNNssssccccrrrroooollllllllHHHHoooorrrriiiizzzzoooonnnnttttaaaallll
  611.                     Adds a ScrollBar that allows the user to scroll
  612.                     horizontally through text when the Boolean value
  613.                     is True.  This resource is forced to False when
  614.                     the Text widget is placed in a ScrolledWindow with
  615.                     XXXXmmmmNNNNssssccccrrrroooolllllllliiiinnnnggggPPPPoooolllliiiiccccyyyy set to XXXXmmmmAAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC.
  616.  
  617.           XXXXmmmmNNNNssssccccrrrroooollllllllLLLLeeeeffffttttSSSSiiiiddddeeee
  618.                     Indicates that the vertical ScrollBar should be
  619.                     placed on the left side of the scrolled text
  620.                     window when the Boolean value is True.  This
  621.                     attribute is ignored if XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll is False
  622.                     or the Text resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
  623.                     XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  The default value may depend
  624.                     on the value of the XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.
  625.  
  626.           XXXXmmmmNNNNssssccccrrrroooollllllllTTTTooooppppSSSSiiiiddddeeee
  627.                     Indicates that the horizontal ScrollBar should be
  628.                     placed on the top side of the scrolled text window
  629.                     when the Boolean value is True.
  630.  
  631.           XXXXmmmmNNNNssssccccrrrroooollllllllVVVVeeeerrrrttttiiiiccccaaaallll
  632.                     Adds a ScrollBar that allows the user to scroll
  633.                     vertically through text when the Boolean value is
  634.                     True.  This attribute is ignored if the Text
  635.                     resource XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT.  This
  636.                     resource is forced to False when the Text widget
  637.                     is placed in a ScrolledWindow with
  638.                     XXXXmmmmNNNNssssccccrrrroooolllllllliiiinnnnggggPPPPoooolllliiiiccccyyyy set to XXXXmmmmAAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC.
  639.  
  640.  
  641.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  642.           Text inherits behavior and resources from the following
  643.           superclasses.  For a complete description of each resource,
  644.           refer to the man page for that superclass.
  645.  
  646.                                          XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  647.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee               DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  648.      ________________________________________________________________________________________________
  649.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic                CSG
  650.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap             XmUNSPECIFIED_PIXMAP   CSG
  651.      XmNforeground           XmCForeground           Pixel              dynamic                CSG
  652.  
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                                         (printed 4/30/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  665.  
  666.  
  667.  
  668.      XmNhelpCallback         XmCCallback             XtCallbackList     NULL                   C
  669.      XmNhighlightColor       XmCHighlightColor       Pixel              dynamic                CSG
  670.      XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False                  CSG
  671.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap             dynamic                CSG
  672.      XmNhighlightThickness   XmCHighlightThickness   Dimension          2                      CSG
  673.      XmNnavigationType       XmCNavigationType       XmNavigationType   XmTAB_GROUP            CSG
  674.      XmNshadowThickness      XmCShadowThickness      Dimension          2                      CSG
  675.      XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic                CSG
  676.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap             dynamic                CSG
  677.      XmNtraversalOn          XmCTraversalOn          Boolean            True                   CSG
  678.      XmNunitType             XmCUnitType             unsigned char      dynamic                CSG
  679.      XmNuserData             XmCUserData             XtPointer          NULL                   CSG
  680.  
  681.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  682.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  683.      ______________________________________________________________________________________________________________
  684.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  685.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  686.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  687.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  688.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  689.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  690.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  691.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  692.      XmNdepth                        XmCDepth                        int              dynamic                CG
  693.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  694.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  695.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  696.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  697.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  698.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  699.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  700.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  701.      XmNx                            XmCPosition                     Position         0                      CSG
  702.      XmNy                            XmCPosition                     Position         0                      CSG
  703.  
  704.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  705.           A pointer to the following structure is passed to each
  706.           callback:
  707.  
  708.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  709.           {{{{
  710.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  711.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  712.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  713.  
  714.  
  715.           _r_e_a_s_o_n Indicates why the callback was invoked
  716.  
  717.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback
  718.  
  719.  
  720.  
  721.  
  722.  
  723.      Page 11                                         (printed 4/30/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  731.  
  732.  
  733.  
  734.           The Text widget defines a new callback structure for use
  735.           with verification callbacks.  Note that not all fields are
  736.           relevant for every callback reason.  The application must
  737.           first look at the _r_e_a_s_o_n field and use only the structure
  738.           members that are valid for the particular reason.  The
  739.           values _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, and _t_e_x_t in the callback structure
  740.           XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt may be modified upon receiving
  741.           the callback, and these changes will be reflected as the
  742.           change made to the source of the Text widget.  (For example,
  743.           all keystrokes can be converted to spaces or NULL characters
  744.           when a password is entered into a Text widget.)  The
  745.           application programmer should not overwrite the _t_e_x_t field,
  746.           but should attach data to that pointer.
  747.  
  748.           A pointer to the following structure is passed to callbacks
  749.           for XXXXmmmmNNNNlllloooossssiiiinnnnggggFFFFooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk, and
  750.           XXXXmmmmNNNNmmmmoooottttiiiioooonnnnVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkk.
  751.  
  752.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  753.           {{{{
  754.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  755.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  756.             BBBBoooooooolllleeeeaaaannnn      _d_o_i_t;;;;
  757.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;;;;
  758.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;;;;
  759.             XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkk  _t_e_x_t;;;;
  760.           }}}} XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyPPPPttttrrrr;;;;
  761.  
  762.  
  763.           _r_e_a_s_o_n Indicates why the callback was invoked.
  764.  
  765.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.  It
  766.                  can be NULL.  For example, changes made to the Text
  767.                  widget programmatically do not have an event that can
  768.                  be passed to the associated callback.
  769.  
  770.           _d_o_i_t   Indicates whether the action that invoked the
  771.                  callback is performed.  Setting _d_o_i_t to False negates
  772.                  the action.
  773.  
  774.           _c_u_r_r_I_n_s_e_r_t
  775.                  Indicates the current position of the insert cursor.
  776.  
  777.           _n_e_w_I_n_s_e_r_t
  778.                  Indicates the position at which the user attempts to
  779.                  position the insert cursor.
  780.  
  781.           _s_t_a_r_t_P_o_s
  782.                  Indicates the starting position of the text to
  783.                  modify.  If the callback is not a modify verification
  784.                  callback, this value is the same as _c_u_r_r_I_n_s_e_r_t.
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                                         (printed 4/30/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  797.  
  798.  
  799.  
  800.           _e_n_d_P_o_s Indicates the ending position of the text to modify.
  801.                  If no text is replaced or deleted, the value is the
  802.                  same as _s_t_a_r_t_P_o_s.  If the callback is not a modify
  803.                  verification callback, this value is the same as
  804.                  _c_u_r_r_I_n_s_e_r_t.
  805.  
  806.           _t_e_x_t   Points to a structure of type XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc.  This
  807.                  structure holds the textual information to be
  808.                  inserted.
  809.  
  810.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  811.           {{{{
  812.             cccchhhhaaaarrrr         ****_p_t_r;;;;
  813.             iiiinnnntttt          _l_e_n_g_t_h;;;;
  814.             XXXXmmmmTTTTeeeexxxxttttFFFFoooorrrrmmmmaaaatttt _f_o_r_m_a_t;;;;
  815.           }}}} XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeecccc,,,, ****XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkk;;;;
  816.  
  817.  
  818.           _p_t_r    Points to the text to be inserted.
  819.  
  820.           _l_e_n_g_t_h Specifies the length of the text to be inserted.
  821.  
  822.           _f_o_r_m_a_t Specifies the format of the text, either XXXXmmmmFFFFMMMMTTTT____8888____BBBBIIIITTTT
  823.                  or XXXXmmmmFFFFMMMMTTTT____11116666____BBBBIIIITTTT.
  824.  
  825.  
  826.           A pointer to the following structure is passed to callbacks
  827.           for XXXXmmmmNNNNmmmmooooddddiiiiffffyyyyVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkWWWWccccssss.
  828.  
  829.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  830.           {{{{
  831.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  832.             XXXXEEEEvvvveeeennnntttt       ****_e_v_e_n_t;;;;
  833.             BBBBoooooooolllleeeeaaaannnn      _d_o_i_t;;;;
  834.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t;;;;
  835.             XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn _s_t_a_r_t_P_o_s, _e_n_d_P_o_s;;;;
  836.             XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkWWWWccccssss _t_e_x_t;;;;
  837.           }}}} XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttWWWWccccssss,,,, ****XXXXmmmmTTTTeeeexxxxttttVVVVeeeerrrriiiiffffyyyyPPPPttttrrrrWWWWccccssss;;;;
  838.  
  839.  
  840.           _r_e_a_s_o_n Indicates why the callback was invoked.
  841.  
  842.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback.  It
  843.                  can be NULL.  For example, changes made to the Text
  844.                  widget programmatically do not have an event that can
  845.                  be passed to the associated callback.
  846.  
  847.           _d_o_i_t   Indicates whether the action that invoked the
  848.                  callback is performed.  Setting _d_o_i_t to False negates
  849.                  the action.
  850.  
  851.           _c_u_r_r_I_n_s_e_r_t
  852.  
  853.  
  854.  
  855.      Page 13                                         (printed 4/30/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  863.  
  864.  
  865.  
  866.                  Indicates the current position of the insert cursor.
  867.  
  868.           _n_e_w_I_n_s_e_r_t
  869.                  Indicates the position at which the user attempts to
  870.                  position the insert cursor.
  871.  
  872.           _s_t_a_r_t_P_o_s
  873.                  Indicates the starting position of the text to
  874.                  modify.  If the callback is not a modify verification
  875.                  callback, this value is the same as _c_u_r_r_I_n_s_e_r_t.
  876.  
  877.           _e_n_d_P_o_s Indicates the ending position of the text to modify.
  878.                  If no text is replaced or deleted, the value is the
  879.                  same as _s_t_a_r_t_P_o_s.  If the callback is not a modify
  880.                  verification callback, this value is the same as
  881.                  _c_u_r_r_I_n_s_e_r_t.
  882.  
  883.           _t_e_x_t   Points to a structure of type XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss.
  884.                  This structure holds the textual information to be
  885.                  inserted.
  886.  
  887.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  888.           {{{{
  889.             wwwwcccchhhhaaaarrrr____tttt      ****_w_c_s_p_t_r;;;;
  890.             iiiinnnntttt          _l_e_n_g_t_h;;;;
  891.           }}}} XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkRRRReeeeccccWWWWccccssss,,,, ****XXXXmmmmTTTTeeeexxxxttttBBBBlllloooocccckkkkWWWWccccssss;;;;
  892.  
  893.  
  894.           _w_c_s_p_t_r Points to the wide character text to be inserted.
  895.  
  896.           _l_e_n_g_t_h Specifies the number of characters to be inserted.
  897.  
  898.  
  899.           The following table describes the reasons why the individual
  900.           verification callback structure fields are valid:
  901.  
  902.           RRRReeeeaaaassssoooonnnn                      VVVVaaaalllliiiidddd FFFFiiiieeeellllddddssss
  903.           __________________________________________________
  904.           XXXXmmmmCCCCRRRR____LLLLOOOOSSSSIIIINNNNGGGG____FFFFOOOOCCCCUUUUSSSS           _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t,
  905.                                       _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t,
  906.                                       _s_t_a_r_t_P_o_s, _e_n_d_P_o_s
  907.  
  908.           XXXXmmmmCCCCRRRR____MMMMOOOODDDDIIIIFFFFYYYYIIIINNNNGGGG____TTTTEEEEXXXXTTTT____VVVVAAAALLLLUUUUEEEE   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t,
  909.                                       _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t,
  910.                                       _s_t_a_r_t_P_o_s, _e_n_d_P_o_s, _t_e_x_t
  911.  
  912.           XXXXmmmmCCCCRRRR____MMMMOOOOVVVVIIIINNNNGGGG____IIIINNNNSSSSEEEERRRRTTTT____CCCCUUUURRRRSSSSOOOORRRR   _r_e_a_s_o_n, _e_v_e_n_t, _d_o_i_t,
  913.                                       _c_u_r_r_I_n_s_e_r_t, _n_e_w_I_n_s_e_r_t
  914.  
  915.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  916.           XmText includes translations from XmPrimitive.  The XmText
  917.           translations are listed below.  These translations may not
  918.  
  919.  
  920.  
  921.      Page 14                                         (printed 4/30/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  929.  
  930.  
  931.  
  932.           directly correspond to a translation table.  The actions
  933.           represent the effective behavior of the associated events,
  934.           and they may differ in a right-to-left language environment.
  935.  
  936.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:::: ggggrrrraaaabbbb----ffffooooccccuuuussss(((())))
  937.           BBBBSSSSeeeelllleeeecccctttt MMMMoooottttiiiioooonnnn::::eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((())))
  938.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee::::eeeexxxxtttteeeennnndddd----eeeennnndddd(((())))
  939.  
  940.           BBBBEEEExxxxtttteeeennnndddd PPPPrrrreeeessssssss:::: eeeexxxxtttteeeennnndddd----ssssttttaaaarrrrtttt(((())))
  941.           BBBBEEEExxxxtttteeeennnndddd MMMMoooottttiiiioooonnnn::::eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((())))
  942.           BBBBEEEExxxxtttteeeennnndddd RRRReeeelllleeeeaaaasssseeee::::eeeexxxxtttteeeennnndddd----eeeennnndddd(((())))
  943.  
  944.           BBBBTTTToooogggggggglllleeee PPPPrrrreeeessssssss:::: mmmmoooovvvveeee----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn(((())))
  945.  
  946.           BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::   pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  947.           BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::  sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  948.           BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee:::: ccccooooppppyyyy----ttttoooo(((())))
  949.  
  950.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  951.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  952.           MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  953.  
  954.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  955.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  956.           MMMMAAAAlllltttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  957.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss::::pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  958.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn::::sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((())))
  959.           MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::mmmmoooovvvveeee----ttttoooo(((())))
  960.           MMMMAAAAlllltttt MMMMCCCCttttrrrrllll BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::ccccooooppppyyyy----ttttoooo(((())))
  961.           MMMMAAAAlllltttt MMMMSSSShhhhiiiifffftttt BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee::::mmmmoooovvvveeee----ttttoooo(((())))
  962.  
  963.           KKKKUUUUpppp::::           pppprrrroooocccceeeessssssss----uuuupppp(((())))
  964.           MMMMSSSShhhhiiiifffftttt KKKKUUUUpppp::::    pppprrrroooocccceeeessssssss----sssshhhhiiiifffftttt----uuuupppp(((())))
  965.           MMMMCCCCttttrrrrllll KKKKUUUUpppp::::     bbbbaaaacccckkkkwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh(((())))
  966.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKUUUUpppp::::bbbbaaaacccckkkkwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh((((eeeexxxxtttteeeennnndddd))))
  967.  
  968.           KKKKDDDDoooowwwwnnnn::::         pppprrrroooocccceeeessssssss----ddddoooowwwwnnnn(((())))
  969.           MMMMSSSShhhhiiiifffftttt KKKKDDDDoooowwwwnnnn::::  pppprrrroooocccceeeessssssss----sssshhhhiiiifffftttt----ddddoooowwwwnnnn(((())))
  970.           MMMMCCCCttttrrrrllll KKKKDDDDoooowwwwnnnn::::   ffffoooorrrrwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh(((())))
  971.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKDDDDoooowwwwnnnn::::ffffoooorrrrwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh((((eeeexxxxtttteeeennnndddd))))
  972.  
  973.           KKKKLLLLeeeefffftttt::::         bbbbaaaacccckkkkwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  974.           MMMMSSSShhhhiiiifffftttt KKKKLLLLeeeefffftttt::::  kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((lllleeeefffftttt))))
  975.           MMMMCCCCttttrrrrllll KKKKLLLLeeeefffftttt::::   bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd(((())))
  976.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKLLLLeeeefffftttt::::bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((eeeexxxxtttteeeennnndddd))))
  977.  
  978.           KKKKRRRRiiiigggghhhhtttt::::        ffffoooorrrrwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  979.           MMMMSSSShhhhiiiifffftttt KKKKRRRRiiiigggghhhhtttt:::: kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((rrrriiiigggghhhhtttt))))
  980.           MMMMCCCCttttrrrrllll KKKKRRRRiiiigggghhhhtttt::::  ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd(((())))
  981.           MMMMSSSShhhhiiiifffftttt MMMMCCCCttttrrrrllll KKKKRRRRiiiigggghhhhtttt::::ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((eeeexxxxtttteeeennnndddd))))
  982.  
  983.           KKKKPPPPaaaaggggeeeeUUUUpppp::::       pppprrrreeeevvvviiiioooouuuussss----ppppaaaaggggeeee(((())))
  984.  
  985.  
  986.  
  987.      Page 15                                         (printed 4/30/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  995.  
  996.  
  997.  
  998.           MMMMSSSShhhhiiiifffftttt KKKKPPPPaaaaggggeeeeUUUUpppp::::pppprrrreeeevvvviiiioooouuuussss----ppppaaaaggggeeee((((eeeexxxxtttteeeennnndddd))))
  999.  
  1000.           KKKKPPPPaaaaggggeeeeDDDDoooowwwwnnnn::::     nnnneeeexxxxtttt----ppppaaaaggggeeee(((())))
  1001.           MMMMSSSShhhhiiiifffftttt KKKKPPPPaaaaggggeeeeDDDDoooowwwwnnnn::::nnnneeeexxxxtttt----ppppaaaaggggeeee((((eeeexxxxtttteeeennnndddd))))
  1002.  
  1003.           KKKKPPPPaaaaggggeeeeLLLLeeeefffftttt::::     ppppaaaaggggeeee----lllleeeefffftttt(((())))
  1004.           KKKKPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt::::    ppppaaaaggggeeee----rrrriiiigggghhhhtttt(((())))
  1005.  
  1006.           KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::    bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee(((())))
  1007.           MMMMSSSShhhhiiiifffftttt KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee::::bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee((((eeeexxxxtttteeeennnndddd))))
  1008.  
  1009.           KKKKEEEEnnnnddddLLLLiiiinnnneeee::::      eeeennnndddd----ooooffff----lllliiiinnnneeee(((())))
  1010.           MMMMSSSShhhhiiiifffftttt KKKKEEEEnnnnddddLLLLiiiinnnneeee::::eeeennnndddd----ooooffff----lllliiiinnnneeee((((eeeexxxxtttteeeennnndddd))))
  1011.  
  1012.           KKKKBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa::::    bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----ffffiiiilllleeee(((())))
  1013.           MMMMSSSShhhhiiiifffftttt KKKKBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa::::bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----ffffiiiilllleeee((((eeeexxxxtttteeeennnndddd))))
  1014.  
  1015.           KKKKEEEEnnnnddddDDDDaaaattttaaaa::::      eeeennnndddd----ooooffff----ffffiiiilllleeee(((())))
  1016.           MMMMSSSShhhhiiiifffftttt KKKKEEEEnnnnddddDDDDaaaattttaaaa::::eeeennnndddd----ooooffff----ffffiiiilllleeee((((eeeexxxxtttteeeennnndddd))))
  1017.  
  1018.           KKKKTTTTaaaabbbb::::          pppprrrroooocccceeeessssssss----ttttaaaabbbb(((())))
  1019.           KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd::::    nnnneeeexxxxtttt----ttttaaaabbbb----ggggrrrroooouuuupppp(((())))
  1020.           KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd::::    pppprrrreeeevvvv----ttttaaaabbbb----ggggrrrroooouuuupppp(((())))
  1021.  
  1022.           KKKKEEEEnnnntttteeeerrrr::::        pppprrrroooocccceeeessssssss----rrrreeeettttuuuurrrrnnnn(((())))
  1023.           KKKKAAAAccccttttiiiivvvvaaaatttteeee::::     aaaaccccttttiiiivvvvaaaatttteeee(((())))
  1024.  
  1025.           KKKKDDDDeeeelllleeeetttteeee::::       ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  1026.           KKKKBBBBaaaacccckkkkSSSSppppaaaacccceeee::::    ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----cccchhhhaaaarrrraaaacccctttteeeerrrr(((())))
  1027.  
  1028.           KKKKAAAAddddddddMMMMooooddddeeee::::      ttttoooogggggggglllleeee----aaaadddddddd----mmmmooooddddeeee(((())))
  1029.  
  1030.           KKKKSSSSppppaaaacccceeee::::        sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  1031.           MMMMSSSShhhhiiiifffftttt KKKKSSSSppppaaaacccceeee:::: sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  1032.           KKKKSSSSeeeelllleeeecccctttt::::       sssseeeetttt----aaaannnncccchhhhoooorrrr(((())))
  1033.           KKKKEEEExxxxtttteeeennnndddd::::       kkkkeeeeyyyy----sssseeeelllleeeecccctttt(((())))
  1034.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll::::  pppprrrroooocccceeeessssssss----ccccaaaannnncccceeeellll(((())))
  1035.           KKKKCCCClllleeeeaaaarrrr::::        cccclllleeeeaaaarrrr----sssseeeelllleeeeccccttttiiiioooonnnn(((())))
  1036.           KKKKSSSSeeeelllleeeeccccttttAAAAllllllll::::    sssseeeelllleeeecccctttt----aaaallllllll(((())))
  1037.           KKKKDDDDeeeesssseeeelllleeeeccccttttAAAAllllllll::::  ddddeeeesssseeeelllleeeecccctttt----aaaallllllll(((())))
  1038.  
  1039.           KKKKCCCCuuuutttt::::          ccccuuuutttt----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  1040.           KKKKCCCCooooppppyyyy::::         ccccooooppppyyyy----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  1041.           KKKKPPPPaaaasssstttteeee::::        ppppaaaasssstttteeee----cccclllliiiippppbbbbooooaaaarrrrdddd(((())))
  1042.  
  1043.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCuuuutttt::::   ccccuuuutttt----pppprrrriiiimmmmaaaarrrryyyy(((())))
  1044.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyCCCCooooppppyyyy::::  ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((())))
  1045.           KKKKPPPPrrrriiiimmmmaaaarrrryyyyPPPPaaaasssstttteeee:::: ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((())))
  1046.  
  1047.           KKKKHHHHeeeellllpppp::::         HHHHeeeellllpppp(((())))
  1048.  
  1049.           KKKKAAAAnnnnyyyy::::          sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((())))
  1050.  
  1051.  
  1052.  
  1053.      Page 16                                         (printed 4/30/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1061.  
  1062.  
  1063.  
  1064.         AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss
  1065.           The XmText action routines are described below:
  1066.  
  1067.  
  1068.           aaaaccccttttiiiivvvvaaaatttteeee(((()))):
  1069.                     Calls the callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk.  If
  1070.                     the parent is a manager, passes the event to the
  1071.                     parent.
  1072.  
  1073.           bbbbaaaacccckkkkwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1074.                     Moves the insertion cursor one character to the
  1075.                     left.  For other effects, see the description of
  1076.                     navigation operations in the "Keyboard Selection"
  1077.                     section.  This action may have different behavior
  1078.                     in a right-to-left language environment.
  1079.  
  1080.           bbbbaaaacccckkkkwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh((((_e_x_t_e_n_d)))):
  1081.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
  1082.                     action is called with no argument, moves the
  1083.                     insertion cursor to the first non-whitespace
  1084.                     character following the first previous blank line
  1085.                     or beginning of the text.  If the insertion cursor
  1086.                     is already at the beginning of a paragraph, moves
  1087.                     the insertion cursor to the beginning of the
  1088.                     previous paragraph.  For other effects, see the
  1089.                     description of navigation operations in the
  1090.                     "Keyboard Selection" section.
  1091.  
  1092.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
  1093.                     action is called with an argument of eeeexxxxtttteeeennnndddd, moves
  1094.                     the insertion cursor as in the case of no argument
  1095.                     and extends the current selection.  For other
  1096.                     effects, see the description of shifted navigation
  1097.                     operations in the "Keyboard Selection" section.
  1098.  
  1099.           bbbbaaaacccckkkkwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((_e_x_t_e_n_d)))):
  1100.                     If this action is called with no argument, moves
  1101.                     the insertion cursor to the first non-whitespace
  1102.                     character after the first whitespace character to
  1103.                     the left or after the beginning of the line.  If
  1104.                     the insertion cursor is already at the beginning
  1105.                     of a word, moves the insertion cursor to the
  1106.                     beginning of the previous word.  For other
  1107.                     effects, see the description of navigation
  1108.                     operations in the "Keyboard Selection" section.
  1109.                     This action may have different behavior in a
  1110.                     locale other than the C locale.
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.      Page 17                                         (printed 4/30/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1127.  
  1128.  
  1129.  
  1130.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1131.                     insertion cursor as in the case of no argument and
  1132.                     extends the current selection.  For other effects,
  1133.                     see the description of shifted navigation
  1134.                     operations in the "Keyboard Selection" section.
  1135.  
  1136.           bbbbeeeeeeeepppp(((()))):   Causes the terminal to beep.
  1137.  
  1138.           bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----ffffiiiilllleeee((((_e_x_t_e_n_d)))):
  1139.                     If this action is called with no argument, moves
  1140.                     the insertion cursor to the beginning of the text.
  1141.                     For other effects, see the description of
  1142.                     navigation operations in the "Keyboard Selection"
  1143.                     section.
  1144.  
  1145.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1146.                     insertion cursor as in the case of no argument and
  1147.                     extends the current selection.  For other effects,
  1148.                     see the description of shifted navigation
  1149.                     operations in the "Keyboard Selection" section.
  1150.  
  1151.           bbbbeeeeggggiiiinnnnnnnniiiinnnngggg----ooooffff----lllliiiinnnneeee((((_e_x_t_e_n_d)))):
  1152.                     If this action is called with no argument, moves
  1153.                     the insertion cursor to the beginning of the line.
  1154.                     For other effects, see the description of
  1155.                     navigation operations in the "Keyboard Selection"
  1156.                     section.
  1157.  
  1158.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1159.                     insertion cursor as in the case of no argument and
  1160.                     extends the current selection.  For other effects,
  1161.                     see the description of shifted navigation
  1162.                     operations in the "Keyboard Selection" section.
  1163.  
  1164.           cccclllleeeeaaaarrrr----sssseeeelllleeeeccccttttiiiioooonnnn(((()))):
  1165.                     Clears the current selection by replacing each
  1166.                     character except <<<<RRRReeeettttuuuurrrrnnnn>>>> with a <<<<ssssppppaaaacccceeee>>>>
  1167.                     character.
  1168.  
  1169.           ccccooooppppyyyy----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  1170.                     Copies the current selection to the clipboard.
  1171.  
  1172.           ccccooooppppyyyy----pppprrrriiiimmmmaaaarrrryyyy(((()))):
  1173.                     Copies the primary selection to just before the
  1174.                     insertion cursor.
  1175.  
  1176.           ccccooooppppyyyy----ttttoooo(((()))):
  1177.                     If a secondary selection exists, copies the
  1178.                     secondary selection to just before the insertion
  1179.                     cursor.  If no secondary selection exists, copies
  1180.                     the primary selection to the pointer location.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.      Page 18                                         (printed 4/30/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1193.  
  1194.  
  1195.  
  1196.           ccccuuuutttt----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  1197.                     Cuts the current selection to the clipboard.
  1198.  
  1199.           ccccuuuutttt----pppprrrriiiimmmmaaaarrrryyyy(((()))):
  1200.                     Cuts the primary selection to just before the
  1201.                     insertion cursor.
  1202.  
  1203.           ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1204.                     In normal mode if there is a non-null selection,
  1205.                     deletes the selection, otherwise deletes the
  1206.                     character following the insertion cursor.  In add
  1207.                     mode if there is a non-null selection, the cursor
  1208.                     is not disjoint from the selection and
  1209.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1210.                     selection, otherwise deletes the character
  1211.                     following the insertion cursor.  This may impact
  1212.                     the selection.
  1213.  
  1214.           ddddeeeelllleeeetttteeee----nnnneeeexxxxtttt----wwwwoooorrrrdddd(((()))):
  1215.                     In normal mode if there is a non-null selection,
  1216.                     deletes the selection, otherwise deletes the
  1217.                     characters following the insertion cursor to the
  1218.                     next space, tab or end of line character.  In add
  1219.                     mode if there is a non-null selection, the cursor
  1220.                     is not disjoint from the selection and
  1221.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1222.                     selection, otherwise deletes the characters
  1223.                     following the insertion cursor to the next space,
  1224.                     tab or end of line character.  This may impact the
  1225.                     selection.  This action may have different
  1226.                     behavior in a locale other than the C locale.
  1227.  
  1228.           ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1229.                     In normal mode if there is a non-null selection,
  1230.                     deletes the selection, otherwise deletes the
  1231.                     character of text immediately preceding the
  1232.                     insertion cursor.  In add mode if there is a non-
  1233.                     null selection, the cursor is not disjoint from
  1234.                     the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
  1235.                     deletes the selection, otherwise deletes the
  1236.                     character of text immediately preceding the
  1237.                     insertion cursor.  This may impact the selection.
  1238.  
  1239.           ddddeeeelllleeeetttteeee----pppprrrreeeevvvviiiioooouuuussss----wwwwoooorrrrdddd(((()))):
  1240.                     In normal mode if there is a non-null selection,
  1241.                     deletes the selection, otherwise deletes the
  1242.                     characters preceding the insertion cursor to the
  1243.                     next space, tab or beginning of the line
  1244.                     character.  In add mode if there is a non-null
  1245.                     selection, the cursor is not disjoint from the
  1246.                     selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
  1247.                     deletes the selection, otherwise deletes the
  1248.  
  1249.  
  1250.  
  1251.      Page 19                                         (printed 4/30/98)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1259.  
  1260.  
  1261.  
  1262.                     characters preceding the insertion cursor to the
  1263.                     next space, tab or beginning of line character..
  1264.                     This may impact the selection.  This action may
  1265.                     have different behavior in a locale other than the
  1266.                     C locale.
  1267.  
  1268.           ddddeeeelllleeeetttteeee----sssseeeelllleeeeccccttttiiiioooonnnn(((()))):
  1269.                     Deletes the current selection.
  1270.  
  1271.           ddddeeeelllleeeetttteeee----ttttoooo----eeeennnndddd----ooooffff----lllliiiinnnneeee(((()))):
  1272.                     In normal mode if there is a non-null selection,
  1273.                     deletes the selection, otherwise deletes the
  1274.                     characters following the insertion cursor to the
  1275.                     next end of line character.  In add mode if there
  1276.                     is a non-null selection, the cursor is not
  1277.                     disjoint from the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  1278.                     is set to True, deletes the selection, otherwise
  1279.                     deletes the characters following the insertion
  1280.                     cursor to the next end of line character.  This
  1281.                     may impact the selection.
  1282.  
  1283.           ddddeeeelllleeeetttteeee----ttttoooo----ssssttttaaaarrrrtttt----ooooffff----lllliiiinnnneeee(((()))):
  1284.                     In normal mode if there is a non-null selection,
  1285.                     deletes the selection, otherwise deletes the
  1286.                     characters preceding the insertion cursor to the
  1287.                     previous beginning of line character.  In add mode
  1288.                     if there is a non-null selection, the cursor is
  1289.                     not disjoint from the selection and
  1290.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1291.                     selection, otherwise deletes the characters
  1292.                     preceding the insertion cursor to the previous
  1293.                     beginning of line character.  This may impact the
  1294.                     selection.
  1295.  
  1296.           ddddeeeesssseeeelllleeeecccctttt----aaaallllllll(((()))):
  1297.                     Deselects the current selection.
  1298.  
  1299.           eeeennnndddd----ooooffff----ffffiiiilllleeee((((_e_x_t_e_n_d)))):
  1300.                     If this action is called with no argument, moves
  1301.                     the insertion cursor to the end of the text.  For
  1302.                     other effects, see the description of navigation
  1303.                     operations in the "Keyboard Selection" section.
  1304.  
  1305.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1306.                     insertion cursor as in the case of no argument and
  1307.                     extends the current selection.  For other effects,
  1308.                     see the description of shifted navigation
  1309.                     operations in the "Keyboard Selection" section.
  1310.  
  1311.           eeeennnndddd----ooooffff----lllliiiinnnneeee((((_e_x_t_e_n_d)))):
  1312.                     If this action is called with no argument, moves
  1313.                     the insertion cursor to the end of the line.  For
  1314.  
  1315.  
  1316.  
  1317.      Page 20                                         (printed 4/30/98)
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1325.  
  1326.  
  1327.  
  1328.                     other effects, see the description of navigation
  1329.                     operations in the "Keyboard Selection" section.
  1330.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1331.                     insertion cursor as in the case of no argument and
  1332.                     extends the current selection.  For other effects,
  1333.                     see the description of shifted navigation
  1334.                     operations in the "Keyboard Selection" section.
  1335.  
  1336.           eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((()))):
  1337.                     Selects text from the anchor to the pointer
  1338.                     position and deselects text outside that range.
  1339.                     Moving the pointer over several lines selects text
  1340.                     from the anchor to the end of each line the
  1341.                     pointer moves over and up to the pointer position
  1342.                     on the current line.
  1343.  
  1344.           eeeexxxxtttteeeennnndddd----eeeennnndddd(((()))):
  1345.                     Moves the insertion cursor to the position of the
  1346.                     pointer.
  1347.  
  1348.           eeeexxxxtttteeeennnndddd----ssssttttaaaarrrrtttt(((()))):
  1349.                     Adjusts the anchor using the balance-beam method.
  1350.                     Selects text from the anchor to the pointer
  1351.                     position and deselects text outside that range.
  1352.  
  1353.           ffffoooorrrrwwwwaaaarrrrdddd----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1354.                     Moves the insertion cursor one character to the
  1355.                     right.  For other effects, see the description of
  1356.                     navigation operations in the "Keyboard Selection"
  1357.                     section.  This action may have different behavior
  1358.                     in a right-to-left language environment.
  1359.  
  1360.           ffffoooorrrrwwwwaaaarrrrdddd----ppppaaaarrrraaaaggggrrrraaaapppphhhh((((_e_x_t_e_n_d)))):
  1361.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, and this
  1362.                     action is called with no argument, moves the
  1363.                     insertion cursor to the first non-whitespace
  1364.                     character following the next blank line.  If the
  1365.                     insertion cursor is already at the beginning of a
  1366.                     paragraph, moves the insertion cursor to the
  1367.                     beginning of the next paragraph.  For other
  1368.                     effects, see the description of navigation
  1369.                     operations in the "Keyboard Selection" section.
  1370.  
  1371.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and this
  1372.                     action is called with an argument of eeeexxxxtttteeeennnndddd, moves
  1373.                     the insertion cursor as in the case of no argument
  1374.                     and extends the current selection.  For other
  1375.                     effects, see the description of shifted navigation
  1376.                     operations in the "Keyboard Selection" section.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.      Page 21                                         (printed 4/30/98)
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1391.  
  1392.  
  1393.  
  1394.           ffffoooorrrrwwwwaaaarrrrdddd----wwwwoooorrrrdddd((((_e_x_t_e_n_d)))):
  1395.                     If this action is called with no argument, moves
  1396.                     the insertion cursor to the first whitespace
  1397.                     character or end of line following the next non-
  1398.                     whitespace character.  If the insertion cursor is
  1399.                     already at the end of a word, moves the insertion
  1400.                     cursor to the end of the next word.  For other
  1401.                     effects, see the description of navigation
  1402.                     operations in the "Keyboard Selection" section.
  1403.                     This action may have different behavior in a
  1404.                     locale other than the C locale.
  1405.  
  1406.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1407.                     insertion cursor as in the case of no argument and
  1408.                     extends the current selection.  For other effects,
  1409.                     see the description of shifted navigation
  1410.                     operations in the "Keyboard Selection" section.
  1411.  
  1412.           ggggrrrraaaabbbb----ffffooooccccuuuussss(((()))):
  1413.                     This key binding performs the action defined in
  1414.                     the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy, depending on the number of
  1415.                     multiple mouse clicks.  The default selection
  1416.                     array ordering is one click to move the insertion
  1417.                     cursor to the pointer position, two clicks to
  1418.                     select a word, three clicks to select a line of
  1419.                     text, and four clicks to select all text.  A
  1420.                     single click also deselects any selected text and
  1421.                     sets the anchor at the pointer position.  This
  1422.                     action may have different behavior in a locale
  1423.                     other than the C locale.
  1424.  
  1425.           HHHHeeeellllpppp(((()))):   Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  1426.                     exist.  If there are no help callbacks for this
  1427.                     widget, this action calls the help callbacks for
  1428.                     the nearest ancestor that has them.
  1429.  
  1430.           iiiinnnnsssseeeerrrrtttt----ssssttttrrrriiiinnnngggg((((_s_t_r_i_n_g)))):
  1431.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1432.                     disjoint from the current selection, deletes the
  1433.                     entire selection.  Inserts _s_t_r_i_n_g before the
  1434.                     insertion cursor.
  1435.  
  1436.           kkkkeeeeyyyy----sssseeeelllleeeecccctttt((((_d_i_r_e_c_t_i_o_n)))):
  1437.                     If called with an argument of rrrriiiigggghhhhtttt, moves the
  1438.                     insertion cursor one character to the right and
  1439.                     extends the current selection.  If called with an
  1440.                     argument of lllleeeefffftttt, moves the insertion cursor one
  1441.                     character to the left and extends the current
  1442.                     selection.  If called with no argument, extends
  1443.                     the current selection.  For other effects, see the
  1444.                     description of shifted navigation operations and
  1445.                     KKKKEEEExxxxtttteeeennnndddd" in the "Keyboard Selection" section.
  1446.  
  1447.  
  1448.  
  1449.      Page 22                                         (printed 4/30/98)
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1457.  
  1458.  
  1459.  
  1460.           kkkkiiiillllllll----nnnneeeexxxxtttt----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1461.                     In normal mode if there is a non-null selection,
  1462.                     deletes the selection, otherwise kills the
  1463.                     character following the insertion cursor and
  1464.                     stores the character in the cut buffer.  In add
  1465.                     mode if there is a non-null selection, the cursor
  1466.                     is not disjoint from the selection and
  1467.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1468.                     selection, otherwise kills the character following
  1469.                     the insertion cursor and stores the character in
  1470.                     the cut buffer.  This may impact the selection.
  1471.  
  1472.           kkkkiiiillllllll----nnnneeeexxxxtttt----wwwwoooorrrrdddd(((()))):
  1473.                     In normal mode if there is a non-null selection,
  1474.                     deletes the selection, otherwise kills the
  1475.                     characters following the insertion cursor to the
  1476.                     next space, tab or end of line character, and
  1477.                     stores the characters in the cut buffer.  In add
  1478.                     mode if there is a non-null selection, the cursor
  1479.                     is not disjoint from the selection and
  1480.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1481.                     selection, otherwise kills the characters
  1482.                     following the insertion cursor to the next space,
  1483.                     tab or end of line character, and stores the
  1484.                     characters in the cut buffer.  This may impact the
  1485.                     selection.  This action may have different
  1486.                     behavior in a locale other than the C locale.
  1487.  
  1488.           kkkkiiiillllllll----pppprrrreeeevvvviiiioooouuuussss----cccchhhhaaaarrrraaaacccctttteeeerrrr(((()))):
  1489.                     In normal mode if there is a non-null selection,
  1490.                     deletes the selection, otherwise kills the
  1491.                     character immediately preceding the insertion
  1492.                     cursor and stores the character in the cut buffer.
  1493.                     In add mode if there is a non-null selection, the
  1494.                     cursor is not disjoint from the selection and
  1495.                     XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True, deletes the
  1496.                     selection, otherwise kills the character
  1497.                     immediately preceding the insertion cursor and
  1498.                     stores the character in the cut buffer.  This may
  1499.                     impact the selection.
  1500.  
  1501.           kkkkiiiillllllll----pppprrrreeeevvvviiiioooouuuussss----wwwwoooorrrrdddd(((()))):
  1502.                     In normal mode if there is a non-null selection,
  1503.                     deletes the selection, otherwise kills the
  1504.                     characters preceding the insertion cursor up to
  1505.                     the next space, tab or beginning of line
  1506.                     character, and stores the characters in the cut
  1507.                     buffer.  In add mode if there is a non-null
  1508.                     selection, the cursor is not disjoint from the
  1509.                     selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is set to True,
  1510.                     deletes the selection, otherwise kills the
  1511.                     characters preceding the insertion cursor up to
  1512.  
  1513.  
  1514.  
  1515.      Page 23                                         (printed 4/30/98)
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1523.  
  1524.  
  1525.  
  1526.                     the next space, tab or beginning of line
  1527.                     character, and stores the characters in the cut
  1528.                     buffer.  This may impact the selection.  This
  1529.                     action may have different behavior in a locale
  1530.                     other than the C locale.
  1531.  
  1532.           kkkkiiiillllllll----sssseeeelllleeeeccccttttiiiioooonnnn(((()))):
  1533.                     Kills the currently selected text and stores the
  1534.                     text in the cut buffer.
  1535.  
  1536.           kkkkiiiillllllll----ttttoooo----eeeennnndddd----ooooffff----lllliiiinnnneeee(((()))):
  1537.                     In normal mode if there is a non-null selection,
  1538.                     deletes the selection, otherwise kills the
  1539.                     characters following the insertion cursor to the
  1540.                     next end of line character and stores the
  1541.                     characters in the cut buffer.  In add mode if
  1542.                     there is a non-null selection, the cursor is not
  1543.                     disjoint from the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  1544.                     is set to True, deletes the selection, otherwise
  1545.                     kills the characters following the insertion
  1546.                     cursor to the next end of line character and
  1547.                     stores the characters in the cut buffer.  This may
  1548.                     impact the selection.
  1549.  
  1550.           kkkkiiiillllllll----ttttoooo----ssssttttaaaarrrrtttt----ooooffff----lllliiiinnnneeee(((()))):
  1551.                     In normal mode if there is a non-null selection,
  1552.                     deletes the selection, otherwise kills the
  1553.                     characters preceding the insertion cursor to the
  1554.                     next beginning of line character and stores the
  1555.                     characters in the cut buffer.  In add mode if
  1556.                     there is a non-null selection, the cursor is not
  1557.                     disjoint from the selection and XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee
  1558.                     is set to True, deletes the selection, otherwise
  1559.                     kills the characters preceding the insertion
  1560.                     cursor to the next beginning of line character and
  1561.                     stores the characters in the cut buffer.  This may
  1562.                     impact the selection.
  1563.  
  1564.           mmmmoooovvvveeee----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn(((()))):
  1565.                     Moves the insertion cursor to the pointer position
  1566.                     without changing any existing current selection.
  1567.                     If there is no current selection, sets the widget
  1568.                     as the destination widget.
  1569.  
  1570.           mmmmoooovvvveeee----ttttoooo(((()))):
  1571.                     If a secondary selection exists, cuts the
  1572.                     secondary selection to the insertion cursor.  If
  1573.                     no secondary selection exists, cuts the primary
  1574.                     selection to the pointer location.
  1575.  
  1576.           nnnneeeewwwwlllliiiinnnneeee(((()))):
  1577.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1578.  
  1579.  
  1580.  
  1581.      Page 24                                         (printed 4/30/98)
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1589.  
  1590.  
  1591.  
  1592.                     disjoint from the current selection, deletes the
  1593.                     entire selection.  Inserts a newline before the
  1594.                     insertion cursor.
  1595.  
  1596.           nnnneeeewwwwlllliiiinnnneeee----aaaannnndddd----bbbbaaaacccckkkkuuuupppp(((()))):
  1597.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1598.                     disjoint from the current selection, deletes the
  1599.                     entire selection.  Inserts a newline just before
  1600.                     the insertion cursor and repositions the insertion
  1601.                     cursor to the end of the line before the newline.
  1602.  
  1603.           nnnneeeewwwwlllliiiinnnneeee----aaaannnndddd----iiiinnnnddddeeeennnntttt(((()))):
  1604.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1605.                     disjoint from the current selection, deletes the
  1606.                     entire selection.  Inserts a newline and then the
  1607.                     same number of whitespace characters as at the
  1608.                     beginning of the previous line.
  1609.  
  1610.           nnnneeeexxxxtttt----lllliiiinnnneeee(((()))):
  1611.                     Moves the insertion cursor to the next line.  For
  1612.                     other effects, see the description of navigation
  1613.                     operations in the "Keyboard Selection" section.
  1614.  
  1615.           nnnneeeexxxxtttt----ppppaaaaggggeeee((((_e_x_t_e_n_d)))):
  1616.                     If this action is called with no argument, moves
  1617.                     the insertion cursor forward one page.  For other
  1618.                     effects, see the description of navigation
  1619.                     operations in the "Keyboard Selection" section.
  1620.  
  1621.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1622.                     insertion cursor as in the case of no argument and
  1623.                     extends the current selection.  For other effects,
  1624.                     see the description of shifted navigation
  1625.                     operations in the "Keyboard Selection" section.
  1626.  
  1627.           nnnneeeexxxxtttt----ttttaaaabbbb----ggggrrrroooouuuupppp(((()))):
  1628.                     Traverses to the next tab group.
  1629.  
  1630.           ppppaaaaggggeeee----lllleeeefffftttt(((()))):
  1631.                     Scrolls the viewing window left one page of text.
  1632.  
  1633.           ppppaaaaggggeeee----rrrriiiigggghhhhtttt(((()))):
  1634.                     Scrolls the viewing window right one page of text.
  1635.  
  1636.           ppppaaaasssstttteeee----cccclllliiiippppbbbbooooaaaarrrrdddd(((()))):
  1637.                     Pastes the contents of the clipboard before the
  1638.                     insertion cursor.
  1639.  
  1640.           pppprrrreeeevvvv----ttttaaaabbbb----ggggrrrroooouuuupppp(((()))):
  1641.                     Traverses to the previous tab group.
  1642.  
  1643.           pppprrrreeeevvvviiiioooouuuussss----lllliiiinnnneeee(((()))):
  1644.  
  1645.  
  1646.  
  1647.      Page 25                                         (printed 4/30/98)
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1655.  
  1656.  
  1657.  
  1658.                     Moves the insertion cursor to the previous line.
  1659.                     For other effects, see the description of
  1660.                     navigation operations in the "Keyboard Selection"
  1661.                     section.
  1662.  
  1663.           pppprrrreeeevvvviiiioooouuuussss----ppppaaaaggggeeee((((_e_x_t_e_n_d)))):
  1664.                     If this action is called with no argument, moves
  1665.                     the insertion cursor back one page.  For other
  1666.                     effects, see the description of navigation
  1667.                     operations in the "Keyboard Selection" section.
  1668.  
  1669.                     If called with an argument of eeeexxxxtttteeeennnndddd, moves the
  1670.                     insertion cursor as in the case of no argument and
  1671.                     extends the current selection.  For other effects,
  1672.                     see the description of shifted navigation
  1673.                     operations in the "Keyboard Selection" section.
  1674.  
  1675.           pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((())))
  1676.                     The result of this action is determined by several
  1677.                     factors:  position of the location cursor,
  1678.                     movement of the location cursor, and the interval
  1679.                     between a BBBBDDDDrrrraaaagggg press and release.
  1680.  
  1681.                     This action copies the current selection to the
  1682.                     insertion cursor if text is selected, the location
  1683.                     cursor is disjoint from the current selection, and
  1684.                     no motion is detected within a given time
  1685.                     interval.
  1686.  
  1687.                     It performs a secondary selection and copies the
  1688.                     selection to the position where the text was last
  1689.                     edited if the cursor is disjoint from a current
  1690.                     selection (if one exists), the time interval is
  1691.                     exceeded, and movement of the location cursor is
  1692.                     detected.
  1693.  
  1694.                     The action drags the current selection if the
  1695.                     location cursor is positioned on the selection,
  1696.                     the time interval is exceeded, and movement of the
  1697.                     location cursor is detected.  This action creates
  1698.                     a DragContext object whose XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss
  1699.                     resource value includes target types of
  1700.                     COMPOUND_TEXT, STRING, and TEXT.
  1701.  
  1702.           pppprrrroooocccceeeessssssss----ccccaaaannnncccceeeellll(((()))):
  1703.                     Cancels the current eeeexxxxtttteeeennnndddd----aaaaddddjjjjuuuusssstttt(((()))), sssseeeeccccoooonnnnddddaaaarrrryyyy----
  1704.                     aaaaddddjjjjuuuusssstttt(((()))) or pppprrrroooocccceeeessssssss----bbbbddddrrrraaaagggg(((()))) operation and leaves
  1705.                     the selection state as it was before the
  1706.                     operation, otherwise, and if the parent is a
  1707.                     manager, passes the event to the parent.
  1708.  
  1709.           pppprrrroooocccceeeessssssss----ddddoooowwwwnnnn(((()))):
  1710.  
  1711.  
  1712.  
  1713.      Page 26                                         (printed 4/30/98)
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1721.  
  1722.  
  1723.  
  1724.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and
  1725.                     XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE, traverses to the
  1726.                     widget below the current one in the tab group.
  1727.  
  1728.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
  1729.                     insertion cursor down one line.  For other
  1730.                     effects, see the description of navigation
  1731.                     operations in the "Keyboard Selection" section.
  1732.  
  1733.           pppprrrroooocccceeeessssssss----hhhhoooommmmeeee(((()))):
  1734.                     Moves the insertion cursor to the beginning of the
  1735.                     line.  For other effects, see the description of
  1736.                     navigation operations in the "Keyboard Selection"
  1737.                     section.
  1738.  
  1739.           pppprrrroooocccceeeessssssss----rrrreeeettttuuuurrrrnnnn(((()))):
  1740.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, calls the
  1741.                     callbacks for XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk, and if the
  1742.                     parent is a manager, passes the event to the
  1743.                     parent.  If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT,
  1744.                     inserts a newline.
  1745.  
  1746.           pppprrrroooocccceeeessssssss----sssshhhhiiiifffftttt----ddddoooowwwwnnnn(((()))):
  1747.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
  1748.                     insertion cursor down one line.  For other
  1749.                     effects, see the description of navigation
  1750.                     operations in the "Keyboard Selection" section.
  1751.  
  1752.           pppprrrroooocccceeeessssssss----sssshhhhiiiifffftttt----uuuupppp(((()))):
  1753.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
  1754.                     insertion cursor up one line.  For other effects,
  1755.                     see the description of navigation operations in
  1756.                     the "Keyboard Selection" section.
  1757.  
  1758.           pppprrrroooocccceeeessssssss----ttttaaaabbbb(((()))):
  1759.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, traverses to
  1760.                     the next tab group.  If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is
  1761.                     XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, inserts a tab.
  1762.  
  1763.           pppprrrroooocccceeeessssssss----uuuupppp(((()))):
  1764.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmSSSSIIIINNNNGGGGLLLLEEEE____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT and
  1765.                     XXXXmmmmNNNNnnnnaaaavvvviiiiggggaaaattttiiiioooonnnnTTTTyyyyppppeeee is XXXXmmmmNNNNOOOONNNNEEEE, traverses to the
  1766.                     widget above the current one in the tab group.
  1767.  
  1768.                     If XXXXmmmmNNNNeeeeddddiiiittttMMMMooooddddeeee is XXXXmmmmMMMMUUUULLLLTTTTIIII____LLLLIIIINNNNEEEE____EEEEDDDDIIIITTTT, moves the
  1769.                     insertion cursor up one line.  For other effects,
  1770.                     see the description of navigation operations in
  1771.                     the "Keyboard Selection" section.
  1772.  
  1773.           rrrreeeeddddrrrraaaawwww----ddddiiiissssppppllllaaaayyyy(((()))):
  1774.                     Redraws the contents of the text window.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.      Page 27                                         (printed 4/30/98)
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1787.  
  1788.  
  1789.  
  1790.           ssssccccrrrroooollllllll----ccccuuuurrrrssssoooorrrr----vvvveeeerrrrttttiiiiccccaaaallllllllyyyy((((_p_e_r_c_e_n_t_a_g_e)))):
  1791.                     Scrolls the line containing the insertion cursor
  1792.                     vertically to an intermediate position in the
  1793.                     visible window based on an input percentage.  A
  1794.                     value of 0 indicates the top of the window; a
  1795.                     value of 100, the bottom of the window.   If this
  1796.                     action is called with no argument, the line
  1797.                     containing the insertion cursor is scrolled
  1798.                     vertically to a new position designated by the _y
  1799.                     position of the event passed to the routine.
  1800.  
  1801.           ssssccccrrrroooollllllll----oooonnnneeee----lllliiiinnnneeee----ddddoooowwwwnnnn(((()))):
  1802.                     Scrolls the text area down one line.
  1803.  
  1804.           ssssccccrrrroooollllllll----oooonnnneeee----lllliiiinnnneeee----uuuupppp(((()))):
  1805.                     Scrolls the text area up one line.
  1806.  
  1807.           sssseeeeccccoooonnnnddddaaaarrrryyyy----aaaaddddjjjjuuuusssstttt(((()))):
  1808.                     Extends the secondary selection to the pointer
  1809.                     position.
  1810.  
  1811.           sssseeeeccccoooonnnnddddaaaarrrryyyy----nnnnoooottttiiiiffffyyyy(((()))):
  1812.                     Copies the secondary selection to the insertion
  1813.                     cursor of the destination widget.
  1814.  
  1815.           sssseeeeccccoooonnnnddddaaaarrrryyyy----ssssttttaaaarrrrtttt(((()))):
  1816.                     Marks the beginning of a secondary selection.
  1817.  
  1818.           sssseeeelllleeeecccctttt----aaaaddddjjjjuuuusssstttt(((()))):
  1819.                     Extends the current selection.  The amount of text
  1820.                     selected depends on the number of mouse clicks, as
  1821.                     specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.
  1822.  
  1823.           sssseeeelllleeeecccctttt----aaaallllllll(((()))):
  1824.                     Selects all text.
  1825.  
  1826.           sssseeeelllleeeecccctttt----eeeennnndddd(((()))):
  1827.                     Extends the current selection.  The amount of text
  1828.                     selected depends on the number of mouse clicks, as
  1829.                     specified by the XXXXmmmmNNNNsssseeeelllleeeeccccttttiiiioooonnnnAAAArrrrrrrraaaayyyy resource.
  1830.  
  1831.           sssseeeelllleeeecccctttt----ssssttttaaaarrrrtttt(((()))):
  1832.                     Marks the beginning of a new selection region.
  1833.  
  1834.           sssseeeellllffff----iiiinnnnsssseeeerrrrtttt(((()))):
  1835.                     If XXXXmmmmNNNNppppeeeennnnddddiiiinnnnggggDDDDeeeelllleeeetttteeee is True and the cursor is not
  1836.                     disjoint from the current selection, deletes the
  1837.                     entire selection.  Inserts the character
  1838.                     associated with the key pressed at the insertion
  1839.                     cursor.
  1840.  
  1841.           sssseeeetttt----aaaannnncccchhhhoooorrrr(((()))):
  1842.  
  1843.  
  1844.  
  1845.      Page 28                                         (printed 4/30/98)
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1853.  
  1854.  
  1855.  
  1856.                     Resets the anchor point for extended selections.
  1857.                     Resets the destination of secondary selection
  1858.                     actions.
  1859.  
  1860.           sssseeeetttt----iiiinnnnsssseeeerrrrttttiiiioooonnnn----ppppooooiiiinnnntttt(((()))):
  1861.                     Sets the insertion position.
  1862.  
  1863.           sssseeeetttt----sssseeeelllleeeeccccttttiiiioooonnnn----hhhhiiiinnnntttt(((()))):
  1864.                     Sets the text source and location of the current
  1865.                     selection.
  1866.  
  1867.           ttttoooogggggggglllleeee----aaaadddddddd----mmmmooooddddeeee(((()))):
  1868.                     Toggles the state of Add Mode.
  1869.  
  1870.           ttttoooogggggggglllleeee----oooovvvveeeerrrrssssttttrrrriiiikkkkeeee(((()))):
  1871.                     Toggles the state of the text insertion mode.  By
  1872.                     default, characters typed into the Text widget are
  1873.                     inserted at the position of the insertion cursor.
  1874.                     In overstrike mode, characters entered into the
  1875.                     Text widget replace the characters that directly
  1876.                     follow the insertion cursor.  In overstrike mode,
  1877.                     when the end of a line is reached, characters are
  1878.                     appended to the end of the line.
  1879.  
  1880.           ttttrrrraaaavvvveeeerrrrsssseeee----hhhhoooommmmeeee(((()))):
  1881.                     Traverses to the first widget in the tab group.
  1882.  
  1883.           ttttrrrraaaavvvveeeerrrrsssseeee----nnnneeeexxxxtttt(((()))):
  1884.                     Traverses to the next widget in the tab group.
  1885.  
  1886.           ttttrrrraaaavvvveeeerrrrsssseeee----pppprrrreeeevvvv(((()))):
  1887.                     Traverses to the previous widget in the tab group.
  1888.  
  1889.           uuuunnnnkkkkiiiillllllll(((()))): Restores last killed text to the position of the
  1890.                     insertion cursor.
  1891.  
  1892.  
  1893.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  1894.           This widget has the additional behavior described below:
  1895.  
  1896.  
  1897.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  1898.                     Draws the insertion cursor as solid and starts
  1899.                     blinking the cursor.
  1900.  
  1901.           <<<<FFFFooooccccuuuussssOOOOuuuutttt>>>>:
  1902.                     Displays the insertion cursor as a stippled I-beam
  1903.                     unless it is the destination widget.
  1904.  
  1905.  
  1906.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  1907.           The bindings for virtual keys are vendor specific.  The
  1908.  
  1909.  
  1910.  
  1911.      Page 29                                         (printed 4/30/98)
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.      XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))                UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV                XXXXmmmmTTTTeeeexxxxtttt((((3333XXXX))))
  1919.  
  1920.  
  1921.  
  1922.           following table lists the Text-specific bindings of virtual
  1923.           keys to actual key event descriptions in 1/Motif:
  1924.  
  1925.                               VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss
  1926.                        __________________________________
  1927.                        VVVViiiirrrrttttuuuuaaaallll KKKKeeeeyyyy   AAAAccccttttuuuuaaaallll KKKKeeeeyyyy EEEEvvvveeeennnnttttssss
  1928.                        ____________________________________________________________________
  1929.                        KKKKAAAAccccttttiiiivvvvaaaatttteeee     CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>RRRReeeettttuuuurrrrnnnn
  1930.                                      <<<<KKKKeeeeyyyy>>>>oooossssffffAAAAccccttttiiiivvvvaaaatttteeee
  1931.                        __________________________________
  1932.                        KKKKEEEExxxxtttteeeennnndddd       CCCCttttrrrrllll SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  1933.                                      SSSShhhhiiiifffftttt<<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  1934.                        __________________________________
  1935.                        KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd    CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>TTTTaaaabbbb
  1936.                        __________________________________
  1937.                        KKKKSSSSeeeelllleeeecccctttt       CCCCttttrrrrllll<<<<KKKKeeeeyyyy>>>>ssssppppaaaacccceeee
  1938.                                      <<<<KKKKeeeeyyyy>>>>oooossssffffSSSSeeeelllleeeecccctttt
  1939.                        __________________________________
  1940.           For information about bindings for virtual buttons and keys,
  1941.           see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  1942.  
  1943.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  1944.           CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccrrrroooolllllllleeeeddddTTTTeeeexxxxtttt((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeexxxxtttt((((3333XXXX)))),
  1945.           XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))), XXXXmmmmFFFFoooonnnnttttLLLLiiiissssttttAAAAppppppppeeeennnnddddEEEEnnnnttttrrrryyyy((((3333XXXX)))), XXXXmmmmPPPPrrrriiiimmmmiiiittttiiiivvvveeee((((3333XXXX)))),
  1946.           XXXXmmmmTTTTeeeexxxxttttCCCClllleeeeaaaarrrrSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttCCCCooooppppyyyy((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttCCCCuuuutttt((((3333XXXX)))),
  1947.           XXXXmmmmTTTTeeeexxxxttttEEEEnnnnaaaabbbblllleeeeRRRReeeeddddiiiissssppppllllaaaayyyy((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttDDDDiiiissssaaaabbbblllleeeeRRRReeeeddddiiiissssppppllllaaaayyyy((((3333XXXX)))),
  1948.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiieeeelllldddd((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttFFFFiiiinnnnddddSSSSttttrrrriiiinnnngggg((((3333XXXX)))),
  1949.           XXXXmmmmTTTTeeeexxxxttttFFFFiiiinnnnddddSSSSttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttBBBBaaaasssseeeelllliiiinnnneeee((((3333XXXX)))),
  1950.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttEEEEddddiiiittttaaaabbbblllleeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))),
  1951.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttLLLLaaaassssttttPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh((((3333XXXX)))),
  1952.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnWWWWccccssss((((3333XXXX)))),
  1953.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSoooouuuurrrrcccceeee((((3333XXXX)))),
  1954.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSttttrrrriiiinnnngggg((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))),
  1955.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnngggg((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttSSSSuuuubbbbssssttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))),
  1956.           XXXXmmmmTTTTeeeexxxxttttGGGGeeeettttTTTTooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttIIIInnnnsssseeeerrrrtttt((((3333XXXX)))),
  1957.           XXXXmmmmTTTTeeeexxxxttttIIIInnnnsssseeeerrrrttttWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttPPPPaaaasssstttteeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttPPPPoooossssTTTTooooXXXXYYYY((((3333XXXX)))),
  1958.           XXXXmmmmTTTTeeeexxxxttttPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttRRRReeeemmmmoooovvvveeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttRRRReeeeppppllllaaaacccceeee((((3333XXXX)))),
  1959.           XXXXmmmmTTTTeeeexxxxttttRRRReeeeppppllllaaaacccceeeeWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSccccrrrroooollllllll((((3333XXXX)))),
  1960.           XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttAAAAddddddddMMMMooooddddeeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttEEEEddddiiiittttaaaabbbblllleeee((((3333XXXX)))),
  1961.           XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttHHHHiiiigggghhhhlllliiiigggghhhhtttt((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttIIIInnnnsssseeeerrrrttttiiiioooonnnnPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))),
  1962.           XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttMMMMaaaaxxxxLLLLeeeennnnggggtttthhhh((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333XXXX)))),
  1963.           XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSoooouuuurrrrcccceeee((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnngggg((((3333XXXX)))),
  1964.           XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttSSSSttttrrrriiiinnnnggggWWWWccccssss((((3333XXXX)))), XXXXmmmmTTTTeeeexxxxttttSSSSeeeettttTTTTooooppppCCCChhhhaaaarrrraaaacccctttteeeerrrr((((3333XXXX)))),
  1965.           XXXXmmmmTTTTeeeexxxxttttSSSShhhhoooowwwwPPPPoooossssiiiittttiiiioooonnnn((((3333XXXX)))), and XXXXmmmmTTTTeeeexxxxttttXXXXYYYYTTTTooooPPPPoooossss((((3333XXXX)))).
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.      Page 30                                         (printed 4/30/98)
  1978.  
  1979.  
  1980.  
  1981.